home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / cli / findstring.lha / FindString.doc < prev   
Text File  |  1995-10-26  |  2KB  |  78 lines
  1.  
  2.     $VER: FindString V1.0 (25.10.95)
  3.           ==========================
  4.  
  5. Introducing
  6.   With FindString you can search a succession of characters (string) in a file.
  7.   Any permutation of user definable chars will find. You can also specify
  8.   the length of the string and the alignment.
  9.   CLI only (no GUI).
  10.   
  11.   
  12. Requirements
  13.   Kickstart 2.05 (V37) or better
  14.   
  15.  
  16. Disclaimer
  17.   This software is subject to the "Standard Amiga FD-Software Copyright Note"
  18.   It is Freeware as defined in paragraph 4a.
  19.   For more information please read "AFD-COPYRIGHT" (Version 1 or higher).
  20.  
  21.  
  22. Installation
  23.   just copy FindString anywhere you like (e.g. C:)
  24.  
  25.  
  26. Using
  27.   - open a Shell and type in "FindString <name_of_file>"
  28.     FindString will load the file and print out all founded strings.
  29.     The value at the start of each line is the relative offset in file.
  30.     Example:
  31.      > FindString DH0:Disk.info
  32.     FindString 1.0 (95-Okt-25 23:44:03) by Bert Jahn
  33.     loading file ¢1mWorkbench:Disk.info¢22m
  34.     $   836 -> "System"
  35.     $   83D -> "DiskCopy"
  36.   - You can break FindString with CTRL-C.
  37.   - FindString is PURE and can made resident
  38.   - see CLI-Convention for further details
  39.  
  40.  
  41. The CLI-Convention
  42.   - Template :
  43.     FindString FILE/A,MINSIZE/K/N,ALIGN/K/N,CHARS/K
  44.  
  45.     FILE/A        the name of the file to search in
  46.     
  47.     MINSIZE/K/N    specifies the minimum size of strings
  48.             eg: MINSIZE=10 (search for strings with size >= 10)
  49.             default: MINSIZE=4
  50.  
  51.     ALIGN/K/N    perform search only on aligned addresses
  52.             the specified value must be a power of 2 and <= 32768
  53.             eg: ALIGN=512
  54.             default: ALIGN=1
  55.  
  56.     CHARS/K        the chars which can occur in the string
  57.             eg: CHARS=ABCD (only strings build of A,B,C and D)
  58.             default: CHARS="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijk
  59.             lmnopqrstuvwxyz1234567890 !()-,.?"
  60.  
  61.  
  62. Bugs
  63.   - the temp output buffer is 64 bytes long, so if there is a string with 67
  64.     bytes only the first 64 bytes will print (MINSIZE=4)
  65.  
  66.     
  67. Contact
  68.  
  69. EMail:    jah@pub.th-zwickau.de
  70. WWW:    http://www.th-zwickau.de/~jah
  71. Mail:    Bert Jahn
  72.     WE 9321
  73.     Otto-Hahn-Stra▀e 14
  74.     Zwickau
  75.     08066
  76.     Germany
  77.  
  78.